home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / game / think / MADgic41.readme < prev    next >
Text File  |  1992-08-14  |  8KB  |  174 lines
  1. Short: COREWAR GAME ASSEMBLY VIRUS
  2.  
  3. MADgic41.lzh is Version 4.1 of The MADgic Core: Core War for the Amiga
  4. Copyright 1992 Mark A. Durham.  It is freely distributable in its complete
  5. archived form.
  6.  
  7. The archive should be decompressed to an empty floppy disk to get the
  8. full effect of the system.  It requires about 77% of an 880K disk.
  9.  
  10. Here are just some of the things new for version 4.1 of The MADgic Core:
  11.  
  12. ASR
  13. ---
  14.  
  15.    Multiple file assembly -
  16.       By far the biggest new feature for 4.1 is the ability to assemble
  17.       multiple files with a single invocation of ASR.  From the WorkBench,
  18.       you SHIFT-Select multiple source files while starting up ASR.  ASR
  19.       will issue a report on each individual file as it is assembled as
  20.       well as list the number of successful and failed assemblies at the
  21.       end of execution.  This will work even across volumes (different
  22.       disks).
  23.  
  24.       From the Shell, just type the command ASR followed by a simple
  25.       AmigaDOS pattern (one containing only #'s and/or ?'s).  ASR can
  26.       handle multiple directories with a single pattern.  For instance,
  27.       to assemble all of the ICWS tournament programs in each of the four
  28.       directories as they appear on The MADgic Core disk in df0:,
  29.       issue the command
  30.  
  31.          "ASR df0:#?/#?.s"
  32.  
  33.       ASR can handle even more levels (i.e. #?/#?/#?/#?.s) if necessary.
  34.       Or you can just list multiple files (i.e. "ASR file1 file2 etc.").
  35.  
  36.       This feature has allowed the deletion of all of the object files from
  37.       the tournament program directories to make room for other improvents.
  38.  
  39.    ToolTypes -
  40.       ASR recognizes the following Tooltypes field of the ASR icon set
  41.       using the WorkBench menu Info command.  They are:
  42.  
  43.          WINDOW=<left>/<top>/<width>/<height> where <left> is the left edge
  44.             of the assembly window, <top> is the top edge, <width> is the
  45.             <width>, and <height> is the height (in pixels).  Some
  46.             combinations may not be available and could possibly result in
  47.             a crash.
  48.          NOCOMMAS=<TrueOrFalse> where <TrueOrFalse> is either TRUE or FALSE.
  49.             NOCOMMAS=TRUE tells the assembler not to expect commas between
  50.             operands.  If this option is set, operands are separated by
  51.             whitespace and therefore no whitespace can occur with operand
  52.             expressions.  Ordinarily ASR can determine whether operands
  53.             are separated by whitespace or not, but some instructions can
  54.             be ambiguous.  Example: DAT 2 -1  (Is it "DAT (2-1)" or is it
  55.             "DAT 2, -1"?).
  56.          NOICONS=<TrueOrFalse> where NOICONS=TRUE keeps ASR from saving
  57.             .info files along with the object files.
  58.          DISPLAY=<TrueOrFalse> where DISPLAY=TRUE will list the assembly
  59.             to the window.
  60.          PRINT=<TrueOrFalse> where PRINT=TRUE will list the assembly to the
  61.             PRT: device.
  62.          VERSION=<version> where <version> is 86 for ICWS'86 and 88 is for
  63.             ICWS'88.  The fields for SPL were swapped between ICWS'86 and
  64.             ICWS'88.  This option tells the assembler how to assemble
  65.             instructions like "SPL 0".  The default is ICWS'88.  Only MARS
  66.             truly supports the ICWS'86 style assembly.  SmallMARS and
  67.             FastMARS really expect an ICWS'88 assembly, but otherwise
  68.             behave as ICWS'86 rules dictate.  There is no way for you to
  69.             know whether an object file was assembled as ICWS'86 or ICWS'88,
  70.             so I recommend you use this option only if you absolutely have
  71.             to do so.
  72.  
  73.    Command line options -
  74.       ASR supports many command line options from the Shell.  They are:
  75.  
  76.          -c    Same as NOCOMMAS=TRUE above.
  77.          -i    Same as NOICONS=TRUE above.
  78.          -l    Same as DISPLAY=TRUE above.
  79.          -v86  Same as VERSION=86 above.
  80.          -v88  Same as VERSION=88 above (the default).
  81.  
  82.       There are AmigaDOS style options which fulfill the same functions as
  83.       the above.  Here is the template for the ASR command:
  84.  
  85.          FILES/A/M,D=DISPLAY/S,P=PRINT,NC=NOCOMMAS/S,NI=NOICONS/S:
  86.  
  87.    Redcode support -
  88.       ASR now supports all but the strangest abuses of Core War.  Colons
  89.       and underscores in labels are the most frequent characters now
  90.       supported in 4.1 but not in previous versions.
  91.  
  92.  
  93. MARS
  94. ----
  95.  
  96.    Preloading filenames from WorkBench -
  97.       If you SHIFT-Select one or two object file icons while starting up
  98.       MARS from the WorkBench, the filenames are preloaded into the file
  99.       requester brought up by the Load command.  You still need to issue
  100.       the Load command to actually load the programs.  What is new for 4.1
  101.       is that you can preload the file requester across volumes (disks).
  102.  
  103.    ToolTypes -
  104.       You can set many defaults in the ToolTypes field of the MARS icon by
  105.       using the WorkBench menu Info command.  Here are the recognized tools:
  106.  
  107.          SIZE=<size> where <size> is any of the Core sizes available from
  108.             the Core menu (2000, 4000, 8000, 8192, 16000, 32000, 64000,
  109.             and 128000).
  110.          CYCLES=<maximum cycles before declaring a draw>
  111.          TASKS=<maximum number of tasks per warrior>
  112.          COLOR=<rgb>|<rgb>|<rgb>|<rgb>|<rgb>|<rgb>|<rgb>|<rgb> where each
  113.             r, g, or b is a hexidecimal number (0-F).  The default colors
  114.             are, in this order, grey, light blue, dark blue, white, black,
  115.             light red, dark red, and green.
  116.          VERSION=<version> where <version> is either 86 for the ICWS'86
  117.             standard or 88 for the ICWS'88 standard.
  118.  
  119.       New for 4.1 are:
  120.  
  121.          CPU=<cpu type> where cpu type is MEMORY for Memory-Based and
  122.             REGISTER for Register-Based.
  123.          MEMORY=<left>/<top>/<width>/<height>/<display> where <left> is
  124.             the left edge of the Memory Window, <top> the top edge,
  125.             <width> the width, and <height> is the height.  Some
  126.             combinations may not be available.  <display> is optional and
  127.             can be either ON or OFF.
  128.          TRACE=<left>/<top>/<width>/<height>/<display> where all the fields
  129.             behave the same as above.
  130.          GAUGE=<left>/<display>
  131.          TIMER=<left>/<display>
  132.          SOUND=<switch> where <switch> is either ON or OFF.
  133.  
  134.       MARS does not recognize any flags or commands from the Shell.
  135.  
  136.    Improved Style Guide Compliance -
  137.       The Load requester no longer automatically selects the first string
  138.       gadget.  Select the first gadget with the mouse or type the <TAB> or
  139.       <RETURN> keys to automatically select the first gadget.  Otherwise,
  140.       the <A>, <B>, or <R> keys will activate the A..., B..., or Random
  141.       gadgets, respectively.
  142.  
  143.       Clicking outside active requesters will result in the Wait pointer
  144.       (the 2.0 Stopwatch) being displayed.  The Wait pointer now appears
  145.       during every activity which may impede interacting with the program.
  146.  
  147.    More keyboard shortcuts -
  148.       Almost every menu command now has a keyboard equivalent with at least
  149.       a remote relationship to the command.  (There are exceptions).
  150.  
  151.    New sound features -
  152.       You can now control each warrior's sound volume individually from the
  153.       Sound requester.
  154.  
  155.    New "processor" support -
  156.       MARS now supports a Memory-Based interpretation of the standards as
  157.       well as the original (default, and correct - so say I) Register-Based
  158.       interpretation.
  159.  
  160.    New 2.0-look system gadgets -
  161.       The Trace Window and Memory Window both now have system gadgets with
  162.       2.0-look system gadgets, even under 1.x versions of the operating
  163.       system.  This is a bit of an experimental hack, and I'm not sure
  164.       whether I will keep them - or even if they will work under all
  165.       circumstances.
  166.  
  167.  
  168.         Mark A. Durham (MAD)
  169.  Email: durham@ricevm1.rice.edu
  170.  GEnie: M.DURHAM2
  171. USmail: P.O. Box 301173
  172.         Houston, TX 77230-1173
  173.         USA
  174.